home *** CD-ROM | disk | FTP | other *** search
/ Power DOS 1996 July / Power DOS - July 1996.iso / sound / c_labs / awe / adip.exe / ADIP02.ZIP / WINDOWS / SAMPLE / AWE_DLL.H < prev    next >
C/C++ Source or Header  |  1994-07-08  |  4KB  |  108 lines
  1. /*
  2. ==============================================================================================================
  3.    Name:             AWE_DLL.H
  4.  
  5.    Description:      Entire API message function header file for accessing AWEMAN.DLL.
  6.                      This header file includes the necessary header files inorder to access the AWEMAN.DLL.
  7.                      These header files contains public APIs which is essential to address the APIs provided
  8.                      by AWEMAN.DLL and AWEGUI.DLL.
  9.                      
  10.    Purpose:          Developer API Guide.
  11.  
  12.    Author:           E.W. Khor
  13.                      Copyright 1993,94 Creative Technology Ltd.
  14.  
  15.    Date:             version 1.0    -     27th Jan 1994
  16.  
  17.    Revision:
  18.  
  19. ==============================================================================================================
  20. */
  21.  
  22. #ifndef  _AWE_DLL_H
  23. #define  _AWE_DLL_H
  24.  
  25.  
  26. #include "awe_api.h"          /* Header file for public APIs. Public */
  27.  
  28. #include "errormsg.h"         /* Header file containing legal error messages for DLL and MIDI driver*/
  29. #include "indices.h"          /* Header file containing macro for Effect Type, Variation and Synth emulation */
  30.  
  31. /*
  32. -----------------------------------------------------------------------------------------------------
  33.  
  34.       GLOBAL MACRO AND EXTERN DEFINITION
  35.       
  36. -----------------------------------------------------------------------------------------------------
  37. */
  38. DECLARE_HANDLE32(AWEHANDLE);
  39. /*
  40.       Type define a AWEHANDLE. This handle is required whenever the application requires to access the APIs
  41.       of AWEMAN.DLL. This handle serves as and identification of proper initialization and acquisition of
  42.       AWEMAN.DLL.
  43.       
  44.       Example:
  45.       
  46.       :
  47.  
  48.       int         nCounter;
  49.       AWEHANDLE   hMyID;                  // hMyID stores a copy of AWEManager returned ID.
  50.  
  51.       :
  52.       (Acquire AWE Manager)
  53.       :
  54. */
  55.  
  56. typedef  LRESULT  (FAR PASCAL *LPFNAWEMANAGER)   (AWEHANDLE, UINT, LPARAM, LPARAM);
  57. /*
  58.       The LPFNAWEMANAGER type is used to declare a pointer to the message function. This message function will
  59.       receive all necessary messages from the application who wishes to access its API. This type declaration
  60.       is useful especially when dynamic linking is used.
  61.  
  62.       Example:
  63.       
  64.       :
  65.       
  66.       AWEHANDLE         hMyID;
  67.       LPFNAWEMANAGER    lpfnAWEManager;
  68.       
  69.       :
  70.       lpfnAWEManager = (Retrieve Address of function);
  71.       :
  72. */
  73.  
  74. #ifdef __cplusplus
  75. extern "C" 
  76. {
  77. #endif
  78.  
  79. LRESULT FAR PASCAL _export AWEManager( AWEHANDLE hUserID, UINT unMsg, LPARAM lParam1, LPARAM lParam2 );
  80. /*
  81.    Message Entry Function. This function provides entry to the AWE DLL Manager. An error message will 
  82.    be returned via the LRESULT return type.
  83.  
  84. */
  85.  
  86. LRESULT FAR PASCAL _export AWEControlPanel( LPCSTR lpszAppTitle, BOOL bButton );
  87. /*
  88.    Activates the AWE Control application.
  89.    lpszAppTitle contains a null-terminated string to the caption title of control panel. If NULL is
  90.    specified, the default name 'AWE Control' will be used.
  91.    bButton turns on or off the button which allows control panel to switch to Controller BOB.
  92. */
  93.  
  94. LRESULT FAR PASCAL _export AWEControllerBOB( LPCSTR lpszAppTitle, BOOL bButton );
  95. /*
  96.    Activates the AWE Controller Break-Out-Box.
  97.    lpszAppTitle contains a null-terminated string to the caption title of control panel. If NULL is
  98.    specified, the default name 'AWE Control' will be used.
  99.    bButton turns on or off the button which allows to Controller BOB switch to control panel.
  100. */
  101.  
  102. #ifdef __cplusplus
  103. }
  104. #endif
  105.  
  106.  
  107. #endif      /* _AWEDLL_H */
  108.